es6-map
Map collection as specified in ECMAScript6
Warning:
v0.1 version does not ensure O(1) algorithm complexity (but O(n)). This shortcoming will be addressed in v1.0
Usage
It’s safest to use es6-map as a ponyfill – a polyfill which doesn’t touch global objects:
var Map = require('es6-map');
If you want to make sure your environment implements Map
globally, do:
require('es6-map/implement');
If you strictly want to use the polyfill even if the native Map
exists, do:
var Map = require('es6-map/polyfill');
Installation
$ npm install es6-map
To port it to Browser or any other (non CJS) environment, use your favorite CJS bundler. No favorite yet? Try: Browserify, Webmake or Webpack
API
Best is to refer to specification. Still if you want quick look, follow examples:
var Map = require('es6-map');
var x = {}, y = {}, map = new Map([['raz', 'one'], ['dwa', 'two'], [x, y]]);
map.size;
map.get('raz');
map.get(x);
map.has('raz');
map.has(x);
map.has('foo');
map.set('trzy', 'three');
map.size
map.get('trzy');
map.has('trzy');
map.has('dwa');
map.delete('dwa');
map.size;
map.forEach(function (value, key) {
});
for (value of map) {
}
var iterator = map.values();
iterator.next();
iterator.next();
iterator.next();
iterator.next();
map.clear();
map.size;
Tests ![Build Status](https://travis-ci.org/medikoo/es6-map.png)
$ npm test